Skip to main content

DescribePropertySoftwareDetail

Description

call the DescribePropertySoftwareDetail interface to get the details of a software in the software list.

Request Method

POST

Request Path

/apsara/route/aegis/DescribePropertySoftwareDetail

Request Parameters Common Parameters

NameLocationTypeRequiredSample valueDescription
PathBODYstringNo/etc/testsoftware installation path.
SoftwareVersionBODYstringNo11software version information.
UuidBODYstringNo50d213b4-3a35-427a-b8a5-***the unique ID of the asset instance to which the software belongs.
PageSizeBODYintegerNo5The maximum number of pieces of data per page displayed during a paged query.
CurrentPageBODYintegerNo1the page number of the current page displayed when paging query.
regionIdBODYstringYesNo sample value for this parameter.region id
versionBODYstringNo2016-01-01version of api
NameBODYstringNotes***software name.
RemarkBODYstringNo1.2.3.4server name or IP.

Return data

NameTypeSample valueDescription
Pathstring/etc/testinstallation directory information for software assets.
PropertysarrayNo sample value for this parameter.software information.
PageSizeinteger2The maximum number of pieces of data per page displayed during a paged query.
RequestIdstring9C5AE850-7140-4DE6-B892-055EB0D9F28Arequest ID of the result.
InstallTimestring2017-09-07 10:54:49returned software installation time.
InstanceIdstringi-uf***asset instance ID.
Ipstring1.2.3.1assets correspond to public IP addresses.
Countinteger2the number of data on the current page displayed during paging query.
IntranetIpstring1.2.3.2the asset corresponds to the private IP address.
Namestringaaa_basesoftware name.
InstanceNamestringtestasset name.
PageInfoNo sample value for this parameter.page display information.
TotalCountinteger23the total number of data.
Uuidstring4ef1115b-e423-4b4b-b930-***returned software version information.
InternetIpstring1.2.3.1assets correspond to public IP addresses.
CurrentPageinteger1the page number of the current page displayed when paging query.
Versionstring11the version information corresponding to the software asset.
Createlong2019-06-24the latest data collection time.
CreateTimestamplong1565539587000the latest collection timestamp of the data.

Example

Successful Response example

{
"Path":"/etc/test",
"Propertys":"",
"PageSize":"2",
"RequestId":"9C5AE850-7140-4DE6-B892-055EB0D9F28A",
"InstallTime":"2017-09-07 10:54:49",
"InstanceId":"i-uf***",
"Ip":"1.2.3.1",
"Count":"2",
"IntranetIp":"1.2.3.2",
"Name":"aaa_base",
"InstanceName":"test",
"PageInfo":"",
"TotalCount":"23",
"Uuid":"4ef1115b-e423-4b4b-b930-***",
"InternetIp":"1.2.3.1",
"CurrentPage":"1",
"Version":"11",
"Create":"2019-06-24",
"CreateTimestamp":"1565539587000"
}

Failed Response example

{
"errorSample":
{
"resultCode":-1,
"resultMsg":"system error",
"result":null
}

}

title: DescribePropertySoftwareItem

DescribePropertySoftwareItem

Description

call DescribePropertySoftwareItem interface to obtain all software list information. .

Request Method

POST

Request Path

/apsara/route/aegis/DescribePropertySoftwareItem

Request Parameters Common Parameters

NameLocationTypeRequiredSample valueDescription
PageSizeBODYintegerNo10specifies the number of data items displayed on each page of the list.
CurrentPageBODYintegerNo1specifies the current page number of the returned result.
regionIdBODYstringYesNo sample value for this parameter.region id
versionBODYstringNo2016-01-01version of api
ForceFlushBODYbooleanNotruewhether to force refresh the data to be queried.
NameBODYstringNotestspecify the name of the software to be queried.

Return data

NameTypeSample valueDescription
PageInfostructNo sample value for this parameter.the page that returns the result displays information.
TotalCountinteger5037returns the total number of data.
RequestIdstring3A85CFCF-05C8-451A-9E41-C0D5E96BA407request ID.
PageSizeinteger2The number of data pieces per page in the returned result.
CurrentPageinteger1returns the current page number displayed in the result.
Countinteger2the number of data displayed on the current page of the returned result.
PropertyItemsarrayNo sample value for this parameter.returned software list.
Namestringaaa_basethe name of the returned software asset.

Example

Successful Response example

{
"PageInfo":"",
"TotalCount":"5037",
"RequestId":"3A85CFCF-05C8-451A-9E41-C0D5E96BA407",
"PageSize":"2",
"CurrentPage":"1",
"Count":"2",
"PropertyItems":"",
"Name":"aaa_base"
}

Failed Response example

{
"errorSample":
{
"resultCode":-1,
"resultMsg":"system error",
"result":null
}

}

title: DescribePropertyUsageNewest

DescribePropertyUsageNewest

Description

call the DescribePropertyUsageNewest to query the newly created list of 5 account information.

Request Method

POST

Request Path

/apsara/route/Sas/DescribePropertyUsageNewest

Request Parameters Common Parameters

NameLocationTypeRequiredSample valueDescription
TypeBODYstringNouseraccount type. Value: user: system:
regionIdBODYstringYesNo sample value for this parameter.region id
versionBODYstringNo2016-01-01version of api

Return data

NameTypeSample valueDescription
NewestStatisticItemsarrayNo sample value for this parameter.account information.
Typestringuserthe account created on this server. fixed value: user, which indicates the user account.
RequestIdstring27C78A20-0833-4519-B392-F7963CCFC6ACthe request ID returned by querying the newly created 5 account information.
Createlong1566178646000account creation time.
ItemCountinteger5Number of lists.
Namestringrootaccount name.

Example

Successful Response example

{
"NewestStatisticItems":"",
"Type":"user",
"RequestId":"27C78A20-0833-4519-B392-F7963CCFC6AC",
"Create":"1566178646000",
"ItemCount":"5",
"Name":"root"
}

Failed Response example

{
"errorSample":
{
"resultCode":-1,
"resultMsg":"system error",
"result":null
}

}